Skip to content

GH-49275: [Doc] Update docs to specify disclosure of AI on mailing list messages#49277

Open
thisisnic wants to merge 3 commits into
apache:mainfrom
thisisnic:GH-49275_BOTS
Open

GH-49275: [Doc] Update docs to specify disclosure of AI on mailing list messages#49277
thisisnic wants to merge 3 commits into
apache:mainfrom
thisisnic:GH-49275_BOTS

Conversation

@thisisnic
Copy link
Copy Markdown
Member

@thisisnic thisisnic commented Feb 13, 2026 •
edited by github-actions Bot
Loading

Rationale for this change

Replying to AI on the mailing list is annoying

What changes are included in this PR?

Specify people should disclose

Are these changes tested?

Nah

Are there any user-facing changes?

Just docs

@github-actions
Copy link
Copy Markdown

github-actions Bot commented Feb 13, 2026

⚠️ GitHub issue #49275 has been automatically assigned in GitHub to PR creator.

@thisisnic
Copy link
Copy Markdown
Member Author

thisisnic commented Feb 13, 2026

@rok I had 2 options which seemed different levels of reasonable:

I got two options that seem reasonable:

A.

Using AI tools to help with phrasing or grammar is fine. However, please don't use AI to generate questions on your behalf - we want to help you, not your AI assistant.

B.

Using AI tools to help with phrasing or grammar is fine and doesn't need to be disclosed. However, if AI is more involved in your workflow (e.g. generating questions or diagnosing errors), please let us know so we can tailor our responses appropriately.

What do you think? Could go with something else entirely.

@rok
Copy link
Copy Markdown
Member

rok commented Feb 13, 2026

Option A seems beter for the explicitness. In a "no unattended" agents kinda way

@thisisnic thisisnic marked this pull request as ready for review February 13, 2026 15:55
@thisisnic thisisnic requested review from pitrou and raulcd February 13, 2026 15:56
@rok
Copy link
Copy Markdown
Member

rok commented Feb 13, 2026

I suppose the thinking is that we cannot hope to communicate to unattended agents simply for our communication bandwidth not being scalable.

thisisnic
thisisnic commented Feb 13, 2026
View reviewed changes
Comment thread docs/source/developers/guide/communication.rst Outdated
@github-actions github-actions Bot added awaiting changes Awaiting changes and removed awaiting committer review Awaiting committer review labels Feb 13, 2026
@thisisnic
Copy link
Copy Markdown
Member Author

thisisnic commented Feb 13, 2026

I suppose the thinking is that we cannot hope to communicate to unattended agents simply for our communication bandwidth not being scalable.

Yeah, I think "just a few is fine" sounds reasonable with the current volume, but looking at the recent shenanigans with matplotlib, this feels like it could get out of control very easily. And it's not hard to say "I was working on this PR and the AI tool wanted me to check the following - can you clarify which of those approaches is best?" or something.

@thisisnic thisisnic requested a review from rok March 5, 2026 10:51
@github-actions github-actions Bot added awaiting change review Awaiting change review and removed awaiting changes Awaiting changes labels May 19, 2026
@thisisnic
Copy link
Copy Markdown
Member Author

thisisnic commented May 19, 2026

@AlenkaF and @raulcd - I folded in a few bits and pieces from our earlier chat here, mind giving this a review?

AlenkaF
AlenkaF approved these changes May 19, 2026
View reviewed changes
Copy link
Copy Markdown
Member

@AlenkaF AlenkaF left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks great, thanks for this!

Comment thread docs/source/developers/guide/communication.rst
.. seealso::
More information and links for subscribing to the mailing lists `can be found here <https://arrow.apache.org/community/>`_.

.. note::
Copy link
Copy Markdown
Member

@AlenkaF AlenkaF May 19, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Nice 👍

raulcd
raulcd approved these changes May 22, 2026
View reviewed changes
Copy link
Copy Markdown
Member

@raulcd raulcd left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is great, thanks for adding links to the current resources

Comment thread docs/source/developers/overview.rst
Comment on lines +182 to +184
* Avoid pinging maintainers to request reviews; most maintainers have
limited time, and we will review PRs as bandwidth allows. AI agents
should never tag or ping maintainers.
Copy link
Copy Markdown
Member

@raulcd raulcd May 22, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don't mind the occasional ping from a human contributor but I strongly agree on the AI agents should never tag or ping maintainers. As this is part of the AI guidelines I am completely fine with the overall Avoid pinging maintainers to request reviews on that context.

@github-actions github-actions Bot added awaiting merge Awaiting merge and removed awaiting change review Awaiting change review labels May 22, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@raulcd raulcd raulcd approved these changes

@AlenkaF AlenkaF AlenkaF approved these changes

@pitrou pitrou Awaiting requested review from pitrou

@rok rok Awaiting requested review from rok

Assignees

No one assigned

Labels

awaiting merge Awaiting merge Component: Documentation

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

4 participants

@thisisnic @rok @raulcd @AlenkaF